home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Prog / L-M / mini / readme.txt < prev    next >
Encoding:
Text File  |  1987-10-08  |  4.7 KB  |  101 lines  |  [TEXT/MPS ]
  1. Implementation Notes:
  2.  
  3. Program: MiniTerm -- a simple terminal emulation program.
  4.          Written in MPW C v2.0
  5.  
  6. Author : Jerry LeVan
  7.          325 Boone Trail
  8.          Richmond Ky 40475
  9.          June 3,1987
  10.          
  11. Version 2: Oct 9,1987
  12.  
  13. In order to build the application simply create a folder in the MPW
  14. folder and move the sources into the new folder. Use the enclosed
  15. "Make" file (MiniTerm.mak) to generate the necessary build commands.
  16. (or just use the Build command)
  17.   
  18. Initial Modem settings:
  19.   1200 baud, 8 bit data, one stop bit, no parity and the modem port
  20.   is used. The port can be changed to the printer port by holding down
  21.   the mouse key during the launch. A popup menu will appear and the
  22.   user can then choose a port to attach to. The baud menu can be used
  23.   to set the speed. Permanent changes require program modification.
  24.   (The program was designed to satisfy my immediate needs.)
  25.   
  26. Xmodem notes.
  27.   The Program supports three variations of the Xmodem protocol.
  28.   a) MacBinary (the protection bit is never turned on)
  29.   b) Text  ( only text files may be sent/received and lf's, nulls,
  30.                and ctlZ's are stripped on reception.
  31.              lfs are added after cr's on transmission.)
  32.   c) Straight (only text files are sent / received, on reception data
  33.                  is written as received into the data fork of the log
  34.                file.)
  35.   
  36.   Xon/Xoff flow control is by default enabled,however during an Xmodem
  37.   transfer flow control is turned off and upon completion is returned
  38.   to its state before the transmission.
  39.   
  40.   The default error correction is CCITT CRC (actually it is inverted
  41.   from the data communications standard since the Xmodem protocol
  42.   specifies transmission of the most signicant bit first). On reception
  43.   the CRC invitation will be offered three times and if not ACK'ed
  44.   error correction will default to checksum. If you wish CRC's can
  45.   be disabled, however at low speeds (1200 Baud) the difference is not
  46.   worth the peace of mind that CRC checking provides. There is an
  47.   option "Fast Down Load" that can be selected. This protocol delivers
  48.   error detection but no error correction. The basic idea is that as
  49.   soon as a packet has been received it will be ACK'ed so that the other
  50.   end can immediately start sending the next packet while the current
  51.   packet is being checked for validity. If an error is discovered the 
  52.   transmission will be aborted. I would not reccommend this method unless
  53.   you are running at a very high baud rate over a "noise free" connection.
  54.   
  55.   The user of the program can chose to use 1024 byte buffers (the 
  56.   default of course is 128). This choice is only useful for very
  57.   high speed connections. If the transfer is MacBinary the first block
  58.   only contains the 128 byte MacBinary header. While this is wasteful
  59.   its very easy to implement (just change the value of sectorSize).
  60.   
  61.   
  62.   Since heirarchial and popup menus are used it is essential that
  63.   system file 4.1 or greater be used. During initializtion the program
  64.   checks for the existence of the PopUpMenuSelect trap and if not
  65.   present the program will gracefully terminate.
  66.   
  67.   This program has not been extensively tested but appears to be fairly
  68.   reliable and the Xmodem transfers are very fast. My vax 730 allows
  69.   transfer rates at 103 to 105 bytes/second at 1200 baud (with CRC).
  70.   MacPaint takes less than 20 seconds to transfer at 56KB (checksum,1024
  71.   byte buffers and fast down load options).
  72.   
  73.   Version 2 additions:
  74.   
  75.   Version 2 offers a limited vt102 emulation. The main part of the
  76.   emulation comes from Columbia Universitys's Kermit. Any flaws where
  77.   probally induced by my modifications. I could not find a copyright
  78.   notice in the code but I suspect that there may be some rights reserved
  79.   by Columbia University. My keyboard mapping is a total kludge. I have
  80.   only tested the program on a Mac Plus. All of the Dec Utilities seem
  81.   to function properly.(ie edit phone mail monitor etc...)
  82.   
  83.   I have completely rewritten the Dialer module. This module has no
  84.   global variables and easily be ported to other applications needing
  85.   a dialer.
  86.   
  87.   This version of Miniterm introduces Paced Uploads. The User can specify
  88.   a "pacing" character and a delay between characters. The program
  89.   checks to see if there is a pace character on the current line prior
  90.   to sending the next line.
  91.   
  92.   Users can now specify blink/nonblinking, block/underline, or visible
  93.   /invisible cursor.
  94.   
  95.   One novelty of this program is the ability to "see" control characters.
  96.   If Interpret Controls is not checked all control characters are 
  97.   displayed on the screen. This feature is especially helpful when
  98.   trying to debug protocol problems.
  99.   
  100.   Caveat: This is an experimental program. My main desire is to understand
  101.   how emulators work in the Macintosh environment.